COMMENT ⊗   VALID 00006 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	What is EFTP?
C00004 00003	How do I start EFTP?
C00007 00004	Then what?
C00009 00005	A sample session using EFTP:
C00012 00006	Addenda: IMAGE mode option: R or L 32 bits?
C00014 ENDMK
C⊗;
What is EFTP?

A good question.  EFTP is a very simple transfer protocol used
to transfer files between SAIL and the Ethernet or VAXes.  It 
should be fairly easy to run; but first, here are a few terms:

RECEIVER = SERVER = the place getting the information tranferred
		    to it.  It RECEIVES the file.
SENDER = USER = the place which is SENDING the file.

So far, so good.

N.B: This program will NOT work if your alto's host number
     does not start with 0#!!  For instance, Alto host 0#101#
     is fine and dandy, but Alto host 52#116# is NOT.  We send
     out to 0#nnn# where nnn is your host.

Details of the protocol are in EFTPSP.TTY[1,CT].

How do I start EFTP?

Another good question.  It is very easy.

1.) Start the SERVER up first!!!!   If you do not
    do this, you will probably get an error, and
    in general, you will probably feel very bad.
    Here is an example of someone running EFTP, and
    SERVING from both machines:

At SAIL:			On your Alto:
-- ----				-- ---- ----

.r eftp				>EFTP.RUN
*rECEIVE			*rECEIVE a file
Local file name:foo.bar		name or number of remote host:sail
Mode:aSCII			local file name:foo.bar
Convert CR to CRLF? y

What this all means:
---- ---- --- -----

At SAIL:
-- ----

.r eftp		 	;start up the program
*rECEIVE		;you type "r", the program types out "ECEIVE".
			;this means that you want to receive a file.
Local file name:foo.bar	;put the file I receive into the file FOO.BAR
Mode:aSCII		;you type "a", the program types "SCII".
			;this is for TEXT files only!  All other
			;files must use IMAGE mode (i.e. you type
			;"i", the program types out "MAGE".
Convert CR to CRLF? y	;when transferring TEXT files from the VAX,
			;type "n", otherwise type "y". This disables
			;the auto-CRLF mode when transferring VAX files.

then we go into a listening state.

On your Alto:
-- ---- ----

>EFTP.RUN		;start up the program
*rECEIVE		;you want to receive a file.
name or number of remote host:sail	;listen for data from SAIL.
local file name:foo.bar	;put the file I receive into FOO.BAR

then we go into a listenening state.

N.B.:  only one server can operate from SAIL at any given time!
       If someone else is serving, you will receive a message
       telling you to try again later.  You can find out who
       this other person is by giving the monitor command PJ PUP.
 
Then what?

I'm glad you asked me that.

Next we would like to SEND a file, so we start up the USER.
This is as easy and painless as the other end.

At SAIL:			On your Alto:
-- ----				-- ---- ----

.r eftp				>EFTP.RUN
*sEND				*sEND a file
Local file name:foo.bar		name or number of remote host:sail
Mode:aSCII			local file name:foo.bar
Convert CRLF to CR? y
Host number (octal): 101

What it all means:
---- -- --- -----

At SAIL:
-- ----

.r eftp				;start up EFTP
*sEND				;send my file someplace.  You type "s"
				;and the program responds with "END".
Local file name:foo.bar		;send my file FOO.BAR
Mode: aSCII			;used for TEXT files.  All other files
				;should use IMAGE mode.
Convert CRLF to CR? y		;when sending TEXT files to the VAX, type
				;"n", otherwise type "y".
Host number (octal): 101	;send this file to Alto 101.

Then we start sending data.  Again I stress: have the SERVER waiting for input!

On your Alto:
-- ---- ----

>EFTP.RUN			;start up EFTP
*sEND a file			;send my file. you type "s".
name or number of remote host:sail	;send this file to SAIL.
local file name:foo.bar		;send my file FOO.BAR.

Then we start sending data.  Again, have the SERVER waiting for input.

A sample session using EFTP:

Here I am, Joe Sail User, and I want to transfer my file, which
is called EFTPSPEC.TTY from my Alto (host 0#101#) to my SAIL
directory, calling it EFTP.DOC[1,JSU].

Since I am receiving the file at SAIL, I log into SAIL first
and start up EFTP, thusly:

.r eftp
*rECEIVE
Local file name:EFTP.DOC
Mode:aSCII
Convert CRLF to CR? y
Now go to your Alto and type EFTP <myfilename> TO SAIL



Being a good follower of directions, I rush to my Alto and log in, then:

>EFTP.RUN
*sEND a file
name or number of remote host:SAIL
local file name:eftpspec.tty

Then the file transfer is done.

If I look closely at my SAIL terminal, I will see:
.....................!
Data transfer completed.
*

Each period signifies a correct packet of data being received.
The Exclamation point means I have received the End Of Data packet.
The Star re-prompts me, in case I want to do anything else.

N.B: When you SEND a file from SAIL, the periods and exclamation
     marks mean different things, so don't panic!  A typical file
     sent from SAIL will produce this result:
     .!.!.!.!.!.!.!.!..!.!.!.!.!
     Data transfer completed
     *
   
     Each Period means we sent out a correct packet.
     Each Exclamation point means we received a correct acknowledgement.

Have fun.  Send bugs, complaints, gripes, congratulations, compliments,
	   etc. to CT or KDO.

Addenda: IMAGE mode option: R or L 32 bits?

Unless you are working with .DVI files or have some
other bizarre reason, you should always use the LEFT
32 bits option when using IMAGE mode.

If you ARE transferring DVI files to the VAX, then
here is what you do:
1.) Start up EFTP on the VAX thusly:
	$ EFTP xesv sail foo.bar
	what this does is run EFTP:
	x = RECEIVE.
	e = USE STANDARD EFTP PROTOCOL.
	s = SWAP THE BYTES. (IMPORTANT!)
	v = TYPE THE NAME OF THE FILE, BYTE SIZE, ETC. (NOT IMPORTANT.)

2.) Then start up EFTP at SAIL:
	.R EFTP
	*SEND
	Local file name: FOO.BAR
	Mode: IMAGE
	Use right or left 32 bits? R
	Host (octal): 300


Again, it is very important that you do these things 
differently than your normal run-of-the-mill EFTP:

1.) Swap the bytes when receiving at the VAX.
2.) Use the RIGHT 32 bits option when transmitting from SAIL.